home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / sac.z / sac
Encoding:
Text File  |  1998-10-20  |  7.4 KB  |  131 lines
  1.  
  2.  
  3.  
  4. ssssaaaacccc((((1111MMMM))))                                                                ssssaaaacccc((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_aaaa_cccc - service access controller
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _ssss_aaaa_cccc _----_tttt _s_a_n_i_t_y__i_n_t_e_r_v_a_l
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The Service Access Controller (SAC) is the overseer of the server
  16.      machine.  It is started when the server machine enters multiuser mode.
  17.      The SAC performs several important functions as explained below.
  18.  
  19.      _C_u_s_t_o_m_i_z_i_n_g _t_h_e _S_A_C _e_n_v_i_r_o_n_m_e_n_t.  When _ssss_aaaa_cccc is invoked, it first looks for
  20.      the per-system configuration script _////_eeee_tttt_cccc_////_ssss_aaaa_ffff_////______ssss_yyyy_ssss_cccc_oooo_nnnn_ffff_iiii_gggg.  _ssss_aaaa_cccc interprets
  21.      ______ssss_yyyy_ssss_cccc_oooo_nnnn_ffff_iiii_gggg to customize its own environment.  The modifications made to
  22.      the SAC environment by ______ssss_yyyy_ssss_cccc_oooo_nnnn_ffff_iiii_gggg are inherited by all the children of
  23.      the SAC.  This inherited environment may be modified by the children.
  24.  
  25.      _S_t_a_r_t_i_n_g _p_o_r_t _m_o_n_i_t_o_r_s.  After it has interpreted the ______ssss_yyyy_ssss_cccc_oooo_nnnn_ffff_iiii_gggg file,
  26.      the _ssss_aaaa_cccc reads its administrative file _////_eeee_tttt_cccc_////_ssss_aaaa_ffff_////______ssss_aaaa_cccc_tttt_aaaa_bbbb.  ______ssss_aaaa_cccc_tttt_aaaa_bbbb
  27.      specifies which port monitors are to be started.  For each port monitor
  28.      to be started, _ssss_aaaa_cccc forks a child and creates a _uuuu_tttt_mmmm_pppp entry with the _t_y_p_e
  29.      field set to _LLLL_OOOO_GGGG_IIII_NNNN______PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS.  Each child then interprets its per-port
  30.      monitor configuration script _////_eeee_tttt_cccc_////_ssss_aaaa_ffff_////_p_m_t_a_g_////______cccc_oooo_nnnn_ffff_iiii_gggg, if the file exists.
  31.      These modifications to the environment affect the port monitor and will
  32.      be inherited by all its children.  Finally, the child process _eeee_xxxx_eeee_ccccs the
  33.      port monitor, using the command found in the ______ssss_aaaa_cccc_tttt_aaaa_bbbb entry.
  34.  
  35.      _P_o_l_l_i_n_g _p_o_r_t _m_o_n_i_t_o_r_s _t_o _d_e_t_e_c_t _f_a_i_l_u_r_e.  The _----_tttt option sets the
  36.      frequency with which _ssss_aaaa_cccc polls the port monitors on the system.  This
  37.      time may also be thought of as half of the maximum latency required to
  38.      detect that a port monitor has failed and that recovery action is
  39.      necessary.
  40.  
  41.      _A_d_m_i_n_i_s_t_r_a_t_i_v_e _f_u_n_c_t_i_o_n_s.  The Service Access Controller represents the
  42.      administrative point of control for port monitors.  Its administrative
  43.      tasks are explained below.
  44.      A port monitor may be in one of six states:
  46.      _EEEE_NNNN_AAAA_BBBB_LLLL_EEEE_DDDD   The port monitor is currently running and is accepting
  47.                connections.
  48.  
  49.      _DDDD_IIII_SSSS_AAAA_BBBB_LLLL_EEEE_DDDD  The port monitor is currently running and is not accepting
  50.                connections.
  51.  
  52.      _SSSS_TTTT_AAAA_RRRR_TTTT_IIII_NNNN_GGGG  The port monitor is in the process of starting up.  _SSSS_TTTT_AAAA_RRRR_TTTT_IIII_NNNN_GGGG is
  53.                an intermediate state on the way to _EEEE_NNNN_AAAA_BBBB_LLLL_EEEE_DDDD or _DDDD_IIII_SSSS_AAAA_BBBB_LLLL_EEEE_DDDD.
  54.  
  55.      _FFFF_AAAA_IIII_LLLL_EEEE_DDDD    The port monitor was unable to start and remain running.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. ssssaaaacccc((((1111MMMM))))                                                                ssssaaaacccc((((1111MMMM))))
  70.  
  71.  
  72.  
  73.      _SSSS_TTTT_OOOO_PPPP_PPPP_IIII_NNNN_GGGG  The port monitor has been manually terminated but has not
  74.                completed its shutdown procedure.  _SSSS_TTTT_OOOO_PPPP_PPPP_IIII_NNNN_GGGG is an intermediate
  75.                state on the way to _NNNN_OOOO_TTTT_RRRR_UUUU_NNNN_NNNN_IIII_NNNN_GGGG.
  76.  
  77.      _NNNN_OOOO_TTTT_RRRR_UUUU_NNNN_NNNN_IIII_NNNN_GGGG
  78.                The port monitor is not currently running.  This is the normal
  79.                ``not running'' state.  When a port monitor is killed, all
  80.                ports it was monitoring are inaccessible.  It is not possible
  81.                for an external user to tell whether a port is not being
  82.                monitored or the system is down.  If the port monitor is not
  83.                killed but is in the _DDDD_IIII_SSSS_AAAA_BBBB_LLLL_EEEE_DDDD state, it may be possible
  84.                (depending on the port monitor being used) to write a message
  85.                on the inaccessible port telling the user who is trying to
  86.                access the port that it is disabled.  This is the advantage of
  87.                having a _DDDD_IIII_SSSS_AAAA_BBBB_LLLL_EEEE_DDDD state as well as the _NNNN_OOOO_TTTT_RRRR_UUUU_NNNN_NNNN_IIII_NNNN_GGGG state.
  88.  
  89.      When a port monitor terminates, the SAC frees the _uuuu_tttt_mmmm_pppp entry for that
  90.      port monitor.
  91.  
  92.      The SAC receives all requests to enable, disable, start, or stop port
  93.      monitors and takes the appropriate action.
  94.  
  95.      The SAC is responsible for restarting port monitors that terminate.
  96.      Whether or not the SAC will restart a given port monitor depends on two
  97.      things:
  99.           -  the restart count specified for the port monitor when the port
  100.              monitor was added.
  101.  
  102.           -  the number of times the port monitor has already been restarted
  103.  
  104. FFFFIIIILLLLEEEESSSS
  105.      _////_eeee_tttt_cccc_////_ssss_aaaa_ffff_////______ssss_aaaa_cccc_tttt_aaaa_bbbb
  106.      _////_eeee_tttt_cccc_////_ssss_aaaa_ffff_////______ssss_yyyy_ssss_cccc_oooo_nnnn_ffff_iiii_gggg
  107.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_uuuu_tttt_mmmm_pppp
  108.      _////_vvvv_aaaa_rrrr_////_ssss_aaaa_ffff_////______llll_oooo_gggg
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.